Variables can be used to populate data connection settings (for example: the port number variable [[EBSDB_PORTNUMBER]], replaces the port number value).

To add a new data connection:

1. Click the Dashboard Configuration button from the dashboard ribbon.

   

   The Dashboard screen is displayed.

   

2. Click the Data Connections tab.

   

   The Data Connections tab is displayed.

   

3. Click the Add button to add a new connection.

   

   The new connection screen is displayed.

   

4. Enter the relevant details.

The relevant fields on the Connections tab are described in the following table.

This button	Does this...
Data Connection Title	The name assigned to the data connection. This field is mandatory.
Category	The data connection category. Choose from the drop-down list.
Data Source Type	The data source type. Choose from the drop-down list.
Host Name	The host name. Variable: [[EBSDB_HOSTNAME]]
Port Number	The port number. Variable: [[EBSDB_PORTNUMBER]]
Database Name	The database name. Variable: [[EBSDB_NAME]]
Database Instance	The database instance. Variable: [[EBSDB_INSTANCENAME]]
User Name	The account used to access the database. This field is mandatory. Variable: [[EBSDB_USERNAME]]
Password	The password for the account used to access the database.
Database Date Time Format	The date and time format. Variable: [[DEFAULT_DATABASE_DATE_TIME_FORMAT]]

5. Click Save.

   

   A successful connection is indicated in the Connection field. The connection is added to the sidebar menu.

   

Tables and views can be added to your data connection by selecting from a schema list or by manually creating the item:

To add data to a connection with Select from Schema:

1. Open the relevant data connection and select the Data tab.

   

2. Click Add Table.

   

   The table generation window is displayed where you can add tables or views.

   

3. To enter details from the available options, click the Select from Schema tab.

   

4. Browse to the relevant table or view, click the Expand button to reveal the contents.

   

5. Browse the contents of the table or view. Select the relevant check box to include all columns for a table.

   

   Alternately, click the Select all Columns button to include all columns contained in the relevant table, or click the Expand button to display a columns list.

   

6. Select the columns that you want to include.

   

   You may have to alter the contents of the Name column if the object has already been included in another item in the data connection (for example: change 'Field name' to 'Fieldname').

7. Click the Generate button in the right-hand corner.

   

   The tables are added to the connection.

   

8. Click Save.

To add data to a connection with Manual Creation:

1. Open the relevant data connection and choose the Data tab.

   

2. Click the Add Table button.

   

   The table generation window is displayed where you can add tables or views to your data connection.

   

3. To enter details manually, click the Manual Creation tab.

   

4. Enter the relevant information.

The relevant fields on the Manual Creation tab are described in the following table.

This button	Does this...
Table Name	The name of the table or view
Table Alias	The table or view's alias name.

5. Click the Generate button in the right-hand corner.

   

   The table is added to the connection. To add columns to a table or view, select the relevant object.

   

6. The Details screen is displayed.

   

7. Click the Objects tab.

   The Objects tab is displayed.

   

8. Click the Add Columns button.

   

   The table generation window is displayed

9. Select the columns that you want to include.

   

   You can use the Object Type and Aggregate drop-down fields to change the values associated with the column.

10. Click the Generate button in the right hand-corner.

    

    The selected columns are added to the table.

    

11. Click Save.

To join tables:

1. Open the relevant data connection and choose the Data tab.

   

2. Select an object.

   

   The Details screen is displayed.

   

3. Click the Joins tab.

   The Joins tab is displayed.

   

4. Click the Add table join button.

   

5. Select the table to join.

   

   The select joins sections are dispalyed.

   

6. Browse to the first table that you want to join in the left-hand side section.

   

7. Browse to the second table in the middle section.

   

8. Click the Append to SQL button.

   

   The tables to join are displayed in the Result section.

   

   You can choose the join type from Inner, Left or Right.

9. Click Save.

   The tables are added to the results section.